CHAPTER 3 


MICROSOFT BASIC FUNCTIONS 


The intrinsic functions provided by Microsoft BASIC are 
presented in this chapter. The functions may be called from 
any program without further definition. 


Arguments to functions are always enclosed in parentheses. 
In the formats given for the functions in this chapter, the 
arguments have been abbreviated as follows: 


X and Y Represent any numeric expressions 
I and J Represent integer expressions 
XS and YS Represent string expressions 


If a floating point value is supplied where an integer is 
required, BASIC will round the fractional portion and use 
the resulting integer. 


NOTE 


With the Microsoft BASIC 
interpreter, only integer and 
single precision results are 
returned by functions. Double 
precision functions are 
supported only by the 
Microsoft BASIC Compiler. 
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3.1 ABS 


Format: 
Action: 


Example: 


3.2 ASC 


Format: 


Action: 


Example: 


ABS(X) 
Returns the absolute value of the expression X. 


PRINT ABS(7*(-5)) 
35 
Ok 


ASC(XS$) 


Returns a numerical value that is the ASCII code 
of the first character of the string X$. (See 
Appendix D for ASCII codes.) If X$ is null, an 
“Illegal function call" error is returned. 


10 X$ = "TEST" 
20 PRINT ASC(XS) 
RUN 

84 
Ok 


See the CHRS$ function for ASCII-to-string 
conversion. 
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3.3 ATN 


Format: 


Action: 


Example: 


3.4 CDBL 


Format: 
Action: 


Example: 


ATN(X) 


Returns the arctangent of X in radians. Result 
is in the range -pi/2 to pi/2. The expression X 
may be any numeric type, but the evaluation of 
ATN is always performed in single precision. 


10 INPUT X 
20 PRINT ATN(X) 
RUN 
2.3 
1.24905 
Ok 


CDBL(X) 
Converts X to a double precision number. 


10 A = 454.67 
20 PRINT A;CDBL(A) 
RUN 
454.67 454.6700134277344 
Ok 
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3.5 CHRS 


Format: 


Action: 


Example: 


3.6 CINT 


Format: 


Action: 


Example: 


CHRS$(I) 


Returns a string whose one element has ASCII 
code I. (ASCII codes are listed in Appendix D.) 
CHR$ is commonly used to. send a special 
character to the terminal. For instance, the 
BEL character could be sent (CHRS(7)) as a 
preface to an error message, or a form feed 
could be sent (CHR$(12)) to clear aé_ terminal 
screen and return the cursor to the home 
position. 


PRINT CHRS$(66) 

B 

Ok 

See the ASC function for ASCII-to-numeric 
conversion. 


CINT(X) 


Converts X to an integer by rounding the 
fractional portion. If X is not in the range 
-32768 to 32767, an “Overflow” error occurs. 


PRINT CINT(45.67) 
46 
Ok 


See the CDBL and CSNG functions for converting 
numbers to the double precision and single 
precision data type. See also the FIX and _ INT 
functions, both of which return integers. 


MICROSOFT BASIC FUNCTIONS Page 3-5 


3.7 COS 
Format: 


Action: 


Example: 


3.8 CSNG 


Format: 
Action: 


Example: 


COS(X) 


Returns the cosine of X in radians. The 
calculation of COS(X) is performed in single 
precision. 


10 X = 2*COS(.4) 
20 PRINT X 
RUN 
1.84212 
Ok 


CSNG(X) 
Converts X to a single precision number. 


10 A# = 975.3421# 
20 PRINT Af; CSNG(A#) 
RUN 
975.3421 975.342 
Ok 


See the CINT and CDBL functions for converting 
numbers to the integer and double precision data 
types. 
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3.9 CVI, CVS, CVD 


Format: 


Action: 


Example: 


3.10 EOF 


Format: 


Action: 


Example: 


CVI(<2-byte string>) 
CVS(<4-byte string>) 
CVD(<8-byte string>) 


Convert string values to numeric values. 
Numeric values that are read in from a random 
disk file must be converted from strings back 
into numbers. CVI converts a 2-byte string to 
an integer. CVS converts a 4-byte string to a 
single precision number. CVD converts an 8-byte 
string to a double precision number. 


70 FIELD #1,4 AS NS, 12 AS BS, ... 
80 GET #1 
90 Y=CVS(NS) 


See also MKIS, MKSS, MKDS, Section 3.25 and PART 
II, Chapter 3, Microsoft BASIC Disk I/0, of the 
Microsoft BASIC User’s Guide. 


EOF(<file number>) 


Returns -l1 (true) if the end of a _ sequential 
file has been reached. Use EOF to test for 
end-of-file while INPUTting, to avoid “Input 
past end” errors. 


10 OPEN "I",1, "DATA" 
20 c=0 

30 IF EOF(1) THEN 100 
40 INPUT #1,M(C) 

50 C=C+1:GOTO 30 
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3.11 EXP 


Format: 


Action: 


Example: 


3.12 FIX 


Format: 


Action: 


Examples: 


EXP(X) 


Returns e to the power of X. X must be 
<=87.3365. If EXP overflows, the “Overflow” 
error message is displayed, machine infinity 
with the appropriate sign is supplied as the 
result, and execution continues. 


10 X= 5 
20 PRINT EXP (X-1) 
RUN 
54.5982 
Ok 


FIX(X) 


Returns the truncated integer part of X. FIX(X) 
is equivalent to SGN(X)*INT(ABS(X)). The major 
difference between FIX and INT is that FIX does 
not return the next lower number for negative X. 


PRINT FIX(58.75) 
58 
Ok 


PRINT FIX(-58.75) 
-58 
Ok 
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3.13 FRE 


Format: 


Action: 


Example: 


3.14 HEXS 


Format: 


Action: 


Example: 


FRE(0) 
FRE(X$) 


Arguments to FRE are dummy arguments. FRE 
returns the number of bytes in memory not being 
used by BASIC. 


FRE("") forces a garbage collection before 


returning the number of free bytes. BE 
PATIENT: garbage collection may take 1 to 1-1/2 
minutes. BASIC will not initiate garbage 


collection until all free memory has been used 
up. Therefore, using FRE("") periodically will 
result in shorter delays for each garbage 
collection. 


PRINT FRE(0) 
14542 
Ok 


HEX$ (X) 


Returns a string which’ represents the 
hexadecimal value of the decimal argument. X is 
rounded to an integer before  HEX$(X) is 
evaluated. 


10 INPUT xX 
20 AS = HEXS$(X) 
30 PRINT X “DECIMAL IS " A$ " HEXADECIMAL" 
RUN 
2 32 
32 DECIMAL IS 20 HEXADECIMAL 
Ok 


See the OCTS function for octal conversion. 
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3.15  INKEYS 


Format: 


Action: 


Example: 


3.16 INP 


Format: 


Action: 


Example: 


INKEYS$ 


Returns either a one-character string containing 
a character read from thé terminal or a null 
string if mo character is pending at the 
terminal. No characters will be echoed and all 
characters are passed through tto the program 
except for Control-C, which terminates’ the 
program. (With the Microsoft BASIC Compiler, 
Control-C is also passed through to the 
program. ) 


1000 “TIMED INPUT SUBROUTINE 

1010 RESPONSES="" 

1020 FOR I%=1 TO TIMELIMIT% 

1030 A$=INKEY$ : IF LEN(A$)=0 THEN 1060 
1040 IF ASC(A$)=13 THEN TIMEOUTZ=0 : RETURN 
1050 RESPONSE$=RESPONSES+A$ 

1060 NEXT 1% 

1070 TIMEOUT%=1 : RETURN 


INP(I) 

Returns the byte read from port I. I must be in 
the range O to 255. INP is the complementary 
function to the OUT statement, Section 2.47. 


100 A=INP(255) 
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3.17 INPUTS 


Format: 


Action: 


Example 1: 


Example 2: 


INPUTS(X[, [#]Y]) 


Returns a string of X characters, read from the 
terminal or from file number Y. If the terminal 
is used for input, no characters will be echoed 
and all control characters are passed through 
except Control-C, which is used to interrupt the 
execution of the INPUTS function. 


5 “LIST THE CONTENTS OF A SEQUENTIAL FILE IN 
HEXADECIMAL 

10 OPEN"I",1, "DATA" 

20 IF EOF(1) THEN 50 

30 PRINT HEX$(ASC(INPUTS(1,#1))); 

40 GOTO 20 

50 PRINT 

60 END 


100 PRINT "TYPE P TO PROCEED OR $ TO STOP” 
110 X$=INPUT$(1) 

120 IF X$="P" THEN 500 

130 IF X$="S" THEN 700 ELSE 100 
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; 3.18 INSTR 
\ 


Format: INSTR([I, ]X$,Y$) 


Action: Searches for the first occurrence of string YS 
in XS and returns the position at which the 
match is found. Optional offset I sets’ the 
position for starting the search. I must be in 
the range 1 to 255. If IDLEN(XS) or if xX$ is 
null or if Y$ cannot be found, INSTR returns 0. 
If Y$ is null, INSTR returns I or l. X$ and Y$ 
may be string variables, string expressions or 
string literals. 


Example: 10 X$ = "ABCDEB” 
20 YS = "B" 
30 PRINT INSTR(X$,Y$);INSTR(4,X$, Y$) 
RUN 
2 6 
Ok 
NOTE: If I=0 is specified, error message “ILLEGAL 


ARGUMENT IN <line number>" will be returned. 
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3.19 INT 
Format: INT (X) 
Action: Returns the largest integer <=X. 


Examples: PRINT INT(99.89) 
99 
Ok 


PRINT INT(-12.11) 
-13 
Ok 


See the FIX and CINT functions which also return 
integer values. 


3.20 LEFTS 
Format: LEFTS$(XS,T) 
Action: Returns a string comprised of the leftmost I 


characters of X$. I must be in the range 0 to 
255. If I is greater than LEN(XS), the entire 
string (X$) will be returned. If I=0, the null 
string (length zero) is returned. 


Example: 10 AS = "BASIC" 
20 BS = LEFTS(AS,5) 
30 PRINT BS 
BASIC 
Ok 


Also see the MIDS and RIGHTS functions. 
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3.21 LEN 


Format: 


Action: 


Example: 


Format: 


Action: 


Example: 


LEN(X$) 


Returns the number of characters in XS. 
Non-printing characters and blanks are counted. 


10 X$ = "PORTLAND, OREGON" 
20 PRINT LEN(XS$) 

16 
Ok 


LOC(<file number>) 


With random disk files, LOC returns the _ record 
number just read or written from a GET or PUT. 
If the file was opened but no disk I/O has’ been 
performed yet, LOC returns a 0. With sequential 
files, LOC returns the number of sectors (128 
byte blocks) read from or written to the file 
Since it was OPENed. 


200 IF LOC(1)>50 THEN STOP 


MICROSOFT BASIC FUNCTIONS Page 3-14 


3.23 LOG 

Format: LOG(X) 

Action: Returns the natural logarithm of X. X must be 
greater than zero. 

Example: PRINT LOG(45/7) 

1.86075 
Ok 

3.24 LPOS 

Format: LPOS (X) 

Action: Returns the current position of the line printer 
print head within the line printer buffer. Does 
not necessarily give the physical position of 
the print head. X is a dummy argument. 


Example: 100 IF LPOS(X)>60 THEN LPRINT CHRS$(13) - an 
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3.25 MIDS 


Format: 


Action: 


Example: 


NOTE: 


3.26 MKIS, 


Format: 


Action: 


Example: 


MID$(X$,I[,J]) 


Returns a string of length J characters from X$ 
beginning with the Ith character. I and J must 
be in the range 1 to 255. If J is omitted or if 
there are fewer than J characters to the right 
of the Ith character, all rightmost characters 
beginning with the Ith character are returned. 
If ID>DLEN(XS$), MIDS returns a null string. 


LIST 

10 A$="GOOD " 

20 BS="MORNING EVENING AFTERNOON" 
30 PRINT A$;MID$(B$, 9,7) 

Ok 

RUN 

GOOD EVENING 

Ok 


Also see the LEFTS and RIGHTS functions. 


If I=0 is specified, error message “ILLEGAL 
ARGUMENT IN <line number>" will be returned. 


MKSS, MKDS 


MKIS$S(<integer expression>) 
MKS$(<single precision expression>) 
MKD$(<double precision expression>) 


Convert numeric values to string values. Any 
numeric value that is placed in a random file 
buffer with an LSET or RSET statement must. be 
converted to a string. MKIS converts an integer 
to a 2-byte string. MKS$ converts a_e single 
precision number to a 4-byte_ string. MKDS 
converts a double precision number to an 8-byte 
string. 


90 AMT=(K+T) 

100 FIELD #1, 8 AS DS, 20 AS NS 
110 LSET D$ = MKSS(AMT) 

120 LSET N$ = AS 

130 PUT #1 


see also CVI, CVS, CVD, Section 3.9 and 
Microsoft BASIC Disk I/0, in the Microsoft BASIC 
User’s Guide. 
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3.27 OCTS 


Format: 


Action: 


Example: 


3.28 PEEK 


Format: 


Action: 


Example: 


OCTS(X) 
Returns a string which represents the octal 
value of the decimal argument. X is rounded to 
an integer before OCTS(X) is evaluated. 
PRINT OCTS$(24) 

30 
Ok 


See the HEXS function for hexadecimal 
conversion. 


PEEK(I) 


Returns the byte (decimal integer in the range 0 
to 255) read from memory location I. I must be 
in the range 0 to 65536. PEEK is the 
complementary function to the POKE statement, 
Section 2.48. 


A=PEEK(&H5A00) 


MICROSOFT 


3.29 POS 


Format: 


Action: 


Example: 
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POS(T) 


Returns the current cursor position. The 
leftmost position is 1. X is a dummy argument. 


IF POS(X)>60 THEN PRINT CHRS$(13) 


Also see the LPOS function. 


3.30 RIGHTS 


Format: 


Action: 


Example: 


RIGHTS (X$,1) 


Returns the rightmost I characters of string X$. 
If I=LEN(X$), returns XS. If I=0, the null 
string (length zero) is returned. 


10 A$="DISK BASIC” 

20 PRINT RIGHTS(AS,8) 
RUN 

BASIC 

Ok 


Also see the MIDS and LEFTS functions. 
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3.31 RND 


Format: 


Action: 


Example: 


3.32 SGN 


Format: 


Action: 


Example: 


RND[(X) ] 


Returns a random number between 0 and 1. The 
Same sequence of random numbers is generated 
each time the program is RUN unless the _ random 
number generator is reseeded (see RANDOMIZE, 
section 2.53). However, X<O always restarts the 
Same sequence for any given X. 


X>0 or X omitted generates the next random 
number in the sequence. X=0 repeats the last 
number generated. 


10 FOR I=l TO 5 
20 PRINT INT(RND*100); 
30 NEXT 
RUN 
24 30 31 51 5 
Ok 


SGN(X) 


If X>0, SGN(X) returns l. 
If X=0, SGN(X) returns 0. 
If X<O, SGN(X) returns -l. 


ON SGN(X)+2 GOTO 100,200,300 branches to 100 if 
X is negative, 200 if X is 0 and 300 if X is 
positive. 
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3.33 SIN 

Format: SIN(X) 

Action: Returns the sine of X in radians. SIN(X) is 
calculated in single precision. 
COS (X)=SIN(X+3.14159/2). 

Example: PRINT SIN(1.5) 

-997495 

Ok 

3.34 SPACES 

Format: SPACES (X) 

Action: Returns a string of spaces of length X. The 


expression X is rounded to an integer and must 
be in the range O to 255. 


Example: 10 FOR I = 1 TO 5 
20 X$ = SPACES(L) 
30 PRINT X$;I1 
40 NEXT I 
RUN 


Ok 


Also see the SPC function. 
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3.35 SPC 

Format: SPC(T) 

Action: Prints I blanks on the terminal. SPC may only 
be used with PRINT and LPRINT statements. I 
must be in the range 0 to 255. A“;” is assumed 
to follow the SPC(I) command. 

Example: PRINT "OVER" SPC(15) “THERE” 

OVER THERE 
Ok 
Also see the SPACES function. 

3.36 SQR 

Format: SQR(X) 

Action: Returns the square root of X. X must be >=0. 

Example: 10 FOR X = 10 TO 25 STEP 5 
20 PRINT X, SQR(X) 

30 NEXT 

RUN 
10 3.16228 
15 3.87298 
20 4.47214 
25 5 


Ok 
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3.37 STRS 


Format: 


Action: 


Example: 


STRS(X) 


Returns a string representation of the value of 
X. 


5 REM ARITHMETIC FOR KIDS 
10 INPUT "TYPE A NUMBER" ;N 
20 ON LEN(STRS(N)) GOSUB 30,100, 200, 300, 400, 500 


Also see the VAL function. 


3.38 STRINGS 


Formats: 


Action: 


Example: 


STRINGS(I,J) 
STRINGS(1,X$) 


Returns a string of length I whose characters 
all have ASCII code J or the first character of 
XS. 


10 X$ = STRINGS$(10,45) 
20 PRINT X$ "MONTHLY REPORT” X$ 
RUN 
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3.39 TAB 


Format: 


Action: 


Example: 


3.40 TAN 


Format: 


Action: 


Example: 


TAB(TL) 


Spaces to position I on the’ terminal. If the 
current print position is already beyond space 
I, TAB goes to that position on the next line. 
Space 1 is the leftmost position, and the 
rightmost position is the width minus one. I 
must be in the range 1 to 255. TAB may only be 
used in PRINT and LPRINT statements. 


10 PRINT “NAME” TAB(25) "AMOUNT" : PRINT 
20 READ AS$,B$ 

30 PRINT A$ TAB(25) BS 

40 DATA "G. T. JONES", "$25.00" 


RUN 

NAME AMOUNT 
G. T. JONES $25.00 
Ok 

TAN(X) 


Returns the tangent of X in radians. TAN(X) is 
calculated in single precision. If TAN 
overflows, the "Overflow" error message is 
displayed, machine infinity with the appropriate 
sign is supplied as the result, and execution 
continues. 


10 Y = Q*TAN(X)/2 
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3.41 USR 


Format : 


Action: 


Example: 


3.42 VAL 


Format: 


Action: 


Example: 


USR[<digit>](X) 


Calls the user”s assembly language subroutine 
with the argument X. <digit> is in the range 0 
to 9 and corresponds to the digit supplied with 
the DEF USR_ statement for that routine. If 
<digit> is omitted, USRO is assumed. See 
Assembly Language Subroutines, in the Microsoft 
BASIC User’s Guide. 


40 B = TXSIN(Y) 
50 C = USR(B/2) 
60 D = USR(B/3) 
VAL(X$) 


Returns the numerical value of string X$. The 
VAL function also strips leading blanks, tabs, 
and linefeeds from the argument’ string. For 
example, 


VAL(" -3) 
returns -—3. 


10 READ NAMES ,CITY$,STATES ,ZIPS$ 

20 IF VAL(ZIP$)<90000 OR VAL(ZIP$)>96699 THEN 
PRINT NAMES TAB(25) “OUT OF STATE” 

30 IF VAL(ZIP$)>=90801 AND VAL(ZIP$)<=90815 THEN 
PRINT NAMES TAB(25) "LONG BEACH" 


See the STRS function for numeric to. string 
conversion. 
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3.43 VARPTR 


Format 1: VARPTR(<variable name>) 
Format 2: VARPTR(#<file number>) 


Action: Format 1: Returns the address of the first byte 
of data identified with <variable name>. A 
value must be assigned to <variable name> prior 
to execution of VARPTR. Otherwise an “Illegal 
function call" error results. Any type variable 
name may be used (numeric, string, array), and 
the address returned will be an integer in the 
range 32767 to -32768. If a negative address is 
returned, add it to 65536 to obtain the actual 
address. 


VARPTR is usually used to obtain the address of 
a variable or array so it may be passed to an 
assembly language subroutine. A function call 
of the form VARPTR(A(0O)) is usually specified 


when passing an array, so that the 

lowest-addressed element of the array is 

returned. a 
NOTE: All simple variables should be assigned before 


calling VARPTR for an array, because the 
addresses of the arrays change whenever a new 
simple variable is assigned. 


Format 2: For sequential files, returns the 
starting address of the disk I/0 buffer assigned 
to <file number>. For random files, returns the 
address of the FIELD buffer assigned to <file 
number>. 


Example: 100 X=USR(VARPTR(Y) ) 


Code 


NF 


SN 


RG 


OD 


FC 


APPENDIX A 


Summary of Error Codes and Error Messages 


Number 


1 


Message 


NEXT without FOR 

A variable in a NEXT statement does not 
correspond to any previously executed, 
unmatched FOR statement variable. 


Syntax error 

A line is encountered that contains some 
incorrect sequence of characters (such as 
unmatched parenthesis, misspelled command or 
statement, incorrect punctuation, etc.). 


Return without GOSUB 

A RETURN statement is encountered for which 
there is no previous, unmatched GOSUB 
statement. 


Out of data 

A READ statement is executed when there are 
no DATA statements with unread data remaining 
in the program. 


Illegal function call 

A parameter that is out of range is passed to 
a math or string function. An FC error may 
also occur as the result of: 


l. a negative or unreasonably large 
subscript 


2. a negative or zero argument with LOG 
3. a negative argument to SQR 


4. a negative mantissa with a non-integer 
exponent 


OV 


OM 


BS 


DD 


/0 


ID 


™ 


10 


11 


12 


13 
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5» a call to a USR function for which the 
starting address has not yet been given 


6. an improper argument to MIDS, LEFTS, 
RIGHTS, INP, OUT, WAIT, PEEK, POKE, TAB, 
SPC, STRINGS, SPACES, INSTR, or 
ON..-GOTO. 


Overflow 

The result of a calculation is too large to 
be represented in Microsoft BASIC’s number 
format. If underflow occurs, the result is 
zero and execution continues without an 
error. 


Out of memory 

A program is too large, has too many FOR 
loops or GOSUBs, too many variables, or 
expressions that are too complicated. 


Undefined line 

A line reference in a GOTO, GOSUB, 
IF...THEN...ELSE or DELETE is to a 
nonexistent line. 


Subscript out of range 

An array element is referenced either with a 
subscript that is outside the dimensions of 
the array, or with the wrong number of 
subscripts. 


Redimensioned array 

Two DIM statements are given for the same 
array, or a DIM statement is given for an 
array after the default dimension of 10 has 
been established for that array. 


Division by zero 

A division by zero is encountered in an 
expression, or the operation of involution 
results in zero being raised to a negative 
power. Machine infinity with the sign of the 
numerator is supplied as the result of the 
division, or positive machine infinity is 
supplied as the result of the involution, and 
execution continues. 


Illegal direct 
A statement that is illegal in direct mode is 
entered as a direct mode command. 


Type mismatch 

A string variable name is assigned a numeric 
value or vice versa; a function that expects 
a numeric argument is given a string argument 


OS 


LS 


ST 


CN 


UF 


14 


15 


16 


17 


18 


19 


20 


21 


22 


23 


26 
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or vice versa. 


Out of string space 

String variables have caused BASIC to exceed 
the amount of free memory remaining. BASIC 
will allocate string space dynamically, until 
it runs out of memory. 


String too long 
An attempt is made to create a string more 
than 255 characters long. 


String formula too complex 

A string expression is too long or _ too 
complex. The expression should be broken 
into smaller expressions. 


Can“t continue 
An attempt is made to continue a program 
that: 


1. has halted due to an error, 


2. has been modified during a break in 
execution, or 


3. does not exist. 


Undefined user function 
A USR function is called before the function 
definition (DEF statement) is given. 


No RESUME 
An error trapping routine is entered but 
contains no RESUME statement. 


RESUME without error 
A RESUME statement is encountered before an 
error trapping routine is entered. 


Unprintable error 

An error message is not available for the 
error condition which exists. This is 
usually caused by an ERROR with an undefined 
error code. 


Missing operand 
An expression contains an operator with no 
operand following it. 


Line buffer overflow 
An attempt is made to input a line that has 


too many characters. 


FOR without NEXT 


29 


30 


50 


51 


52 


53 


54 


55 


57 


(| 
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A FOR was encountered without a matching 
NEXT. 


WHILE without WEND 
A WHILE statement does not have a matching 
WEND. 


WEND without WHILE 
A WEND was encountered without 
WHILE. 


ey) 


matching 


Disk Errors 


Field overflow 

A FIELD statement is attempting to allocate 
more bytes than were specified for the record 
length of a random file. 


Internal error 

An internal malfunction has _ occurred in 
Microsoft BASIC. Report to Microsoft the 
conditions under which the message appeared. 


Bad file number 
A statement or command references a file with 
a file number that is not OPEN or is out of 
the range of file numbers specified at 
initialization. 


File not found 
A LOAD, KILL or OPEN statement references a 
file that does not exist on the current disk. 


Bad file mode 

An attempt is made to use PUT, GET, or LOF 
with a sequential file, to LOAD a random file 
or to execute an OPEN with a file mode other 
than I, O, or R. 


File already open 

A sequential output mode OPEN is issued for a 
file that is already open; or a KILL is 
given for a file that is open. 


Disk I/0 error 

An 1/0 error occurred on a disk “1/0 
operation. It is a fatal error, i.e., the 
operating system cannot recover from the 
error. 


disk Fall 


Appendix B 


DISPLAY DRIVER SPECIFICATIONS 


INTRODUCTION B.1 


The software in the BIOS display interface receives ASCII charac- 
ters and either displays them or uses them for display control. 
Characters in the ASCII control set (hex 00 through hex 1F and 
hex 7F) are control characters and are not displayed (see the ESC 
8 exception below). These characters may, however, affect the 
display. Most of the control characters act independently. But for 
some actions, more than one control character is required to 
specify the action. This is done by using the ASCII escape code 
(hex 1B) followed by one or more characters. The control charac- 
ters and the escape sequences are described in B.2 and B.3. 


The display controls are accessed from high-level languages by 
using the PRINT or equivalent statements. For example, in 
MS-BASIC — 

PRINT CHR$(27)+CHR$(112) 


turns on reverse video. 


NOTE: Decimal 27 equals hex 1B, which is Escape, and decimal 
112 is hex 70. 


CONTROL CHARACTERS B.2 
Pm Bell (ALT-G, hex 07): This is not really a display control 


character. It sends the CODEC a series of signals that cause it 
to make the sound of a bell. 
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> Backspace (ALT-H, hex 08): Moves the cursor one column to 
the left. If cursor is at column 1, it moves to column 80 of the 
previous row (unless cursor is at coldmata 1, row | in which case 
it moves to column 80, row 1). 


> Horizontal Tab (ALT-I, hex 09): Moves the cursor to the next 
tab stop. Tab stops are fixed at columns 9, 17, 25, 33, 41, 49, 
57, 65, and 72 through 80. If the cursor is at column 80, it 


remains there. 


> Line Feed (ALT-J, hex 0A): Moves the cursor down one row. If 


cursor is at row 24, then the display scrolls up one row. (The 
Line feed can also be treated as a Return. See ESC x9.) 

> Carriage Return (ALT-M, hex OD): Moves the cursor to col- 
umn | of the current row. (Return can also be treated as a Line 
feed. See ESC x8.) 

> Shift In (ALT-N, hex OE): Shifts to character set 1 (G1). 


> Shift Out (ALT-0,hex OF): Shifts to character set 0 (GO). 


B.3 ESCAPE SEQUENCES 


Table B-1: Cursor Functions 


ASCII CODE 
ESCAPE GENERATED 
SEQUENCE (HEXADECIMAL) —SEQUENCE DEFINITION 

Esc-A LB, 41 Moves the cursor up one 
line. 

Esc-B 1B, 42 Moves the cursor down one 
line without changing 
columns. 

Esc-C LB, 43 Moves the cursor one 
character position to the 
right. 


continued 
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ASCII CODE 
—_ ESCAPE GENERATED 


SEQUENCE (HEXADECIMAL) 


Esc-D 1B, 44 
Esc-H 1B, 48 
Esc-] 1B, 49 
Esc-n 1B, 6E 
Esc-j 1B, 6A 
Esc-k 1B, 6B 
— 
Esc-Y[I][c] LB, 59 
ad 
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SEQUENCE DEFINITION 


Moves the cursor one 
character position to the left. 


Moves the cursor to the 
home position (upper-left 
corner of screen). 


Moves the cursor up one 
line, and stays in the same 
column. 


Reports the cursor position. 


The display driver saves the 
cursor position. 


Returns the cursor to the 
previously-saved cursor 
position. 


Moves the cursor via direct 
cursor addressing, where | is 
the line number (hex) and c 
is the column number (hex). 
The first line and the left 
column are both 20 hex (the 
smallest value of the printing 
characters) and increase from 
there. Since the lines are 
numbered from | to 19 hex 
(from top to bottom) and the 
columns from 1 to 50 hex 
(from left to right), you must 
add the proper line and 
column numbers to 1F. No 
movement occurs if | and/or 
c are invalid. 


B-3 


Table B-2: Editing Functions 


ASCII CODE 
ESCAPE GENERATED 
SEQUENCE (HEXADECIMAL) SEQUENCE DEFINITION 


Esc-E 
Esc-b 


Esc-] 


Esc-l 


Esc-o 


Esc-K 


Esc-L 


Esc-M 


Esc-N 


Esc-@ 


Esc-O 


1B, 45 
1B, 62 


1B, 4A 


1B, 6C 
1B, 6F 


1B, 4B 


1B, 4C 


1B, 4D 


1B, 4E 


1B, 40 


LB, 4F 


Erases the entire screen. 


Erases from the start of the 
screen up to (and including) 
the cursor position. 


Erases from the cursor 
position to the end of the 
page. 

Erases entire line. 


Erases from the beginning of 
line up to (and including) 
the cursor position. 


Erases from cursor position to 
the end of the line. 


Inserts a blank line. The 
current line and all following 
lines scroll down one line. 
The cursor moves to the 
beginning of the blank line. 


Moves cursor to beginning of 
line, deletes the line, and 
then scrolls all following 
lines up one line. A blank 
line is inserted at line 24. 


Deletes character at cursor 
position and shifts the rest of 
the line one character 
position to the left. 


Enters the Insert Character 
mode. This lets you insert 
characters into screen text. 
As each new character is 
inserted, the character at the 
end of the line is lost. 


Exits Insert Character mode. 
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— Table B-3: Configuration Functions 


ASCII CODE 
ESCAPE GENERATED 
SEQUENCE (HEXADECIMAL) SEQUENCE DEFINITION 
Esc-x[ Ps] 1B, 78 Sets mode(s) as follows: 
Ps _ Mode 
1 Enable 25th line. 
3 Hold screen mode on. 
4 ~~ Use block cursor. 
5 Cursor off. 
8 Automatic line feed 
after a Return. 
9 Automatic Return 
after a line feed. 
A Increase audio volume. 
B Increase CRT 
brightness. 
C Increase CRT contrast. 
Esc-y[Ps] 1B, 79 Resets mode(s) as follows: 
Ps _ Mode 
l Disable 25th line. 
3 Hold screen mode off. 
4 Use underscore cursor. 
5 Cursor on. 
8 No auto line feed. 
9 No auto Return. 
A Decrease audio volume. 
B Decrease CRT 
brightness. 
C Decrease CRT contrast. 
Esc-” 1B, 5E Toggle hold mode. 
Esc-[ 1B, 5B Set hold mode. 
Esc-\ 1B, 5C Clear hold mode. 
Esc- | 1B, 7C Activate user-defined console 
(T.B.A.). 
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Table B-4: Operation Mode Functions 


ASCII CODE 
ESCAPE GENERATED 
SEQUENCE (HEXADECIMAL) SEQUENCE DEFINITION 
Esc-p 1B, 70 Enters reverse video mode. 
Esc-q IB, 71 Exits reverse video mode. 


Table B-5: Special Functions 


ASCII CODE 
ESCAPE GENERATED 
SEQUENCE (HEXADECIMAL) SEQUENCE DEFINITION 
Esc- } 1B, 7D Disables the keyboard. 
Esc-{ 1B, 7B Enables the keyboard. 
Esc-v 1B, 76 Enables wrap-around at the 
end of the line. 
Esc-w 1B, 77 Disables wrap-around at the 
end of the line. 
Esc-z IB, 7A Resets terminal to power-on 
configuration. 
Esc-$ 1B, 24 Transmits the character at 
cursor location. 
Esc-] 1B, 5D Transmits the 25th line. 
Esc-# 1B, 23 Transmits the page. 
Esc-( 1B, 28 Sets high intensity. 
Esc-) 1B, 29 Sets low intensity. 
Esc- + 1B, 2B Clears the foreground. 


(High-intensity displayed 
characters. ) 
Esc-Z IB, 5A Identifies display as 
emulating VT52 (the 
terminal responds with an 
Esc-K). 
Esc-0 1B, 30 Sets the underline mode. 
continued 
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a ASCII CODE 
ESCAPE GENERATED 
SEQUENCE (HEXADECIMAL) SEQUENCE DEFINITION 


Esc-1 1B, 31 Resets the underline mode. 
Esc-2 1B, 32 Enables cursor blink. 

Esc-3 1B, 33 Disables cursor blink. 

Esc-8 1B, 38 Sets the test (literally) mode 


for the next single character. 


Esc-i[n] 1B, 69 Displays the system sign-on 
banner, as follows (n is the 
ASCII numeric character): 


n _ Display 


Entire banner. 
Company logo only. 
Product name only. 
Configuration 
information only. 


Wh = © 


ee 


132-COLUMN UTILITY B.4 
Description 


The 132-column utility (132C) provides a simulated 132-column 
display in the 800-dot by 400-line HIRES display mode of your 
computer. The characters are displayed in a 5-by-7 dot matrix in a 
6-by-10 cell to give the 132-column display. In addition, a stan- 
dard display of 80 columns by 25 lines is simulated with an 8-by-11 
dot matrix in a 10-by-16 cell. The 132 column mode is enabled 
when the normal BIOS display interface recognizes the appropri- 
ate escape sequence. 


Installation 


Enter this sequence to activate the 132 Column feature for use 
with an application program: 


A>132C<cr> 
A>132C-ON <cr> 
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These commands can be combined in a Batch (.BAT) file, if you 
like. 


The 132C feature is turned off with the command: 
A>132C-OFF <cr> 

The 132C program installs itself into the BIOS. The program 
requires about 50K of memory: the 800-by-400-line HIRES screen 
requires 40K; the character sets and code use the rest. The 132C 
program copies itself into the lowest 64K block of memory and 


removes its 50K required bytes from the system until you press the 
reset button or turn off your computer. 


You can access 132C after installing an application program if you 
send an ESC | (1B 7C) to the display interface. This is done from 
MS-BASIC with: 

PRINT CHR$(27)+CHR$(124) 

From MS-BASIC, 132C is turned off with an ESC z (1B 7A): 
PRINT CHR$(27) +“z” 


The display control sequences described above are also available 


in 132C mode. 
When you’ve finished and saved your work, press the reset button 


to release the memory allocated to 132C and return to normal 
character mode. 
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Dec 


000 
001 
002 
003 
004 
005 
006 
007 
008 
009 
010 
O11 
012 
013 
014 
O15 
016 
O17 
018 
019 
020 
021 
022 
023 
024 
025 
026 
027 
028 
029 
030 
031 
032 
033 
034 
035 
036 
037 
038 
039 
040 
041 
042 


Dec=decimal, Hex=hexadecimal (H), CHR=character. 


Hex 


OOH 
O1H 
02H 
03H 
04H 
O5H 
O6H 
07H 
08H 
09H 
OAH 
OBH 
OCH 
ODH 
OEH 
OFH 
10H 
11H 
12H 
13H 
14H 
15H 
16H 
17H 
18H 
19H 
1AH 
1BH 
1CH 
1DH 
1EH 
1FH 
20H 
21H 
22H 
23H 
24H 
25H 
26H 
27H 
28H 
29H 
2AH 


SI 
DLE 
DC1 
DC2 
DC3 
DC4 
NAK 
SYN 
ETB 
CAN 
EM 
SUB 
ESCAPE 
FS 

GS 

RS 

US 
SPACE 


ASCII Character Codes 


Dec 
043 
044 
045 
046 
047 
048 
049 
050 
O51 
052 
053 
054 
055 
056 
057 
058 
059 
060 
061 
062 
063 
064 
065 
066 
067 
068 
069 
070 
O71 
072 
073 
074 
075 
076 
077 
078 
079 
080 
081 
082 
083 
084 
085 
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Hex 


2BH 
2CH 
2DH 
2EH 
2FH 
30H 
31H 
32H 
33H 
34H 
35H 
36H 
37H 
38H 
39H 
3AH 
3BH 
3CH 
3DH 
3EH 
3FH 
40H 
41H 
42H 
43H 
44H 
45H 
46H 
47H 
48H 
49H 
4AH 
4BH 
4CH 
4DH 
4EH 
4FH 
50H 
51H 
52H 
53H 
54H 
55H 


CHR 


-~OMDNDUEWNHrKrO™: 
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Dec 


086 
087 
088 
089 
090 
091 
092 
093 
094 
095 
096 
097 
098 
099 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
Lid 
112 
Li3 
114 
LLD 
116 
LL? 
118 
119 
120 
iZ1 
L22 
123 
124 
125 
126 
127 


Hex 


56H 
57H 
58H 
59H 
5 AH 
5BH 
5CH 
5DH 
5EH 
5FH 
60H 
61H 
62H 
63H 
64H 
65H 
66H 
67H 
68H 
69H 
6AH 
6BH 
6CH 
6DH 
6EH 
6FH 
70H 
71H 
72H 
73H 
74H 
75H 
76H 
77H 
78H 
79H 
7AH 
7BH 
7CH 
7DH 
7EH 
7FH 


\s> 


MA 
~S 


CHR 


re res NK MM SS 


‘| 


lr—$ SNK KM ESE rnrRreOQvvdvoeonArABbBrAur Tomoaan dsm 


DEL 


LF=Line Feed, FF=Form Feed, CR=Carriage Return, DEL=Rubout 


2 Py 


INDEX 


ABS 

Addition . 

ALL 

Arctangent 

Array variables 

ArrayS «© « © © © «© «© « » 

ASC » & 

ASCII codes . 

ASCII format om 
Assembly language subroutines 
ATN. 

AUTO . 


Boolean operators 


CALL . 
Carriage return 


Cassette tape ; 

CDBL .« «@ «@ &@ hh © Bw 8 

CHAIN . s 

Character set .« « « «= © « # 
CHRS . — 

GENT « « «@ } & & ® @ 

CLEAR ie nhea & w 8 
GCUOAD « « «© «& &® * @ w & & o@ 
CLOAD* . in 6m « 
CHOAT? »«»§ «< & wm © & & 

CLOSE » « 

Command level .. +... «2 « « 
COMMON . 
Concatenation 
Constants 

CONT «a © + # © # &@ 
Control characters . 
Control-A .. 

COs 

CSAVE .. 

CSAVE* . 

CSNG . 

CVD 

CVI. 

CVS 


DATA . «© «© © © © «© «© © © « 
DEF FN . ; 

DEF USR ..- « -» 

DEFDBL . o 8 8 
DEFINT .~« «© «© «© © «© « « 
DEFSNG . 


WWW WNYNMWNPFNRPRNHRFNNNNNYM WCOWrN WN ND FP LH 
| 


Rm W bP dh W WRF WYP DW 
by ods os ep spe ee 
v - © 
ho 
oS 


2-50, 2-78 
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| 
ww ww w 


2—2Z 
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I 

_ 
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| 
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2-37, 2-42 to 2-43, 
to 2-86 
2-12 
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w 


2-9 
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2-139, 2+75 


» 2-L4 

» 2-17, 3-23 
. 1=7, 2-16 
» 1-7, 2-16 


I-7, 2-16 


DEFSTR * e ee © e© © © © e# @© @ @ l i 9 2-16 

DELETE e o ee © ee . e ° 1 2 9 2-4 3 2-18 

DIM ° ° e ° ® ° e e e ° ° ° e 2-19 - 

Direct mode « e ee e © #8 «© «@ ° 1-1 9 2-35 9 2-55 e - : 
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Divis ion e e e e 6 e e 6 e e @ 
Double precision ...... » 2-16, 2-61, 3-3 


, 2-20 
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EDEL ow ae oa: Wiel) ei Pee “at we @P Se LSD 
Edit mode .......-+ +. 1-4 
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Error codes . . . +. « « « « 1-16, 2-26 to 2-27, A-1 
Error messages ....... . 1-16, A-l 

Error trapping . . « »« « « « « 2-26 to 2-27, 2-55, 2-76 
Escape . « « «© « «© «© «© «© « « « 1-3, 2-20 

EXP 2. 6 « © © © © © © © © @ o Bf 

Exponentiation ....... . 1-10 to 1-1l 
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2-29 
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GET . 6 6 © © © 6 © 6 ow ow oe ew 2-29, 2-32 \aw/ 
GOSUB . « 6 «© © «© © © © ew os ew 2733 


GOTO ee e e #® © © © © © © #© © @ 2-33 to 2-34 


HEXS e e ° ° ° ° ° e e ° ° e ry 3-8 
Hexadecimal . .... 6 « e e« 1-5 
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3-7, 3-12 


KILL « @ #¢ © # e© #8 © © e© #© # @ 2-40 —_—— 


LEFTS e e e ® e e e e e e e e 3-12 


LEN e e e e e e e 
LET ; 
Line feed .... 


LINE INPUT . 


LINE INPUT# ... 


Line numbers . 
Line printer .. . 
Lines 


LIST e e ® Sd ® °o e 


LLIST ne 
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LOC as Tae Us 
LOG. seh ce es te a 
Logical operators 
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MERGE ...... 
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Overflow ..... 
Overlay 


Paper tape ... .- 
PEEK . . So say 6 
POKE .« «© « © « «© « 
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